-- *****************************************************************
-- CISCO-IMAGE-CHECK-MIB.my: Cisco Image Check MIB file
--
-- May 2003, Charuhas Ghatge
--
-- Copyright (c) 2003 by cisco Systems, Inc.
-- All rights reserved.
-- *****************************************************************CISCO-IMAGE-CHECK-MIB DEFINITIONS::=BEGINIMPORTSMODULE-IDENTITY,OBJECT-TYPE,Integer32FROM SNMPv2-SMI
SnmpAdminStringFROM SNMP-FRAMEWORK-MIB
RowStatusFROM SNMPv2-TC
MODULE-COMPLIANCE,OBJECT-GROUP
FROM SNMPv2-CONF
ciscoMgmt
FROM CISCO-SMI;ciscoImageCheckMIB MODULE-IDENTITYLAST-UPDATED"200305150000Z"ORGANIZATION"Cisco Systems, Inc."CONTACT-INFO" Cisco Systems
Customer Service
Postal: 170 W. Tasman Drive
San Jose, CA 95134
USA
Tel: +1 800 553-NETS
E-mail: cs-snmp@cisco.com"DESCRIPTION"Initial version of Image Check MIB."::={ ciscoMgmt 99990}ciscoImageCheckMIBObjects OBJECTIDENTIFIER::={ ciscoImageCheckMIB 1}ciscoImageCheck OBJECTIDENTIFIER::={ ciscoImageCheckMIBObjects 1}--
-- When a switch runs different versions of software on the active
-- and the standby supervisor, the behaviour of the two versions
-- of the software can be different.
-- The objective of this MIB is to perform a HA compatibility check
-- of the two versions of the software and list the incompatibilities
--
-- To achieve this goal, there are 2 tables defined in this MIB.
--
-- ciscoImageCheckOpTable, is an 'operations' table, in that this
-- table is used to invoke a command to perform a check on the
-- images.
--
-- ciscoImgChkResultsTable, is a read-only table where the results of
-- previous operation are read. It is this table that lists the
-- incompatibilities.
--
-- Terminology -
--
-- HA - High Availability
--
-- Feature - A software service like zoning, routing etc.
--
-- Capability - A configuration attribute mapping to some
-- hardware-dependent configuration. A
-- capability is described by this infrastructure if
-- it can be programmed in one version of the software
-- but it can't be programmed in some earlier version.
--
-- Strict and Loose incompatibility - An incompatibility exists
-- between the configuration of the software running
-- on the active supervisor and the configuration
-- supported by the standby supervisor when a specific
-- capability is enabled, but software on the standby
-- supervisor does not support it. The incompatibility
-- is said to be 'Strict', when a switchover to the
-- older version software release would cause some
-- unpredictable behaviour as long as the capability
-- is enabled. The incompatibility is said to be
-- 'Loose' when a switchover to the older release
-- would not cause an unpredictable behaviour or
-- instability in the system.
--
--ciscoImageCheckOpTable OBJECT-TYPE
SYNTAXSEQUENCEOF CiscoImageCheckOpEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"A table of Image check operation entries. Each
entry represents an Image check operation that
has been initiated.
"::={ ciscoImageCheck 1}ciscoImageCheckOpEntry OBJECT-TYPESYNTAX CiscoImageCheckOpEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"An Image check operation entry. Each entry consists
of an image name, current status of the check
operation and a row status.
A management station wishing to create an entry should
first generate a pseudo-random serial number to be used
as the index to this sparse table. The station should
then create the associated instance of the row status
object. It must also, create the associated instance
of the image name. This image is checked for
compatibility with the image already running on the
active supervisor.
Once the appropriate instances of all the mandatory
objects have been created, either by an explicit SNMP
set request or by default, the row status should be set
to active to initiate the operation. Note that this entire
procedure may be initiated via a single set request which
specifies a row status of createAndGo.
Once an operation has been activated, it cannot be
stopped.
Once the operation completes, the management station should
retrieve the value of the status object and delete the
entry. In order to prevent old entries from clogging the
table, entries will be aged out, but an entry will never
be deleted within 5 minutes of completing.
"INDEX{ ciscoImageCheckSerialNum }::={ ciscoImageCheckOpTable 1}
CiscoImageCheckOpEntry ::=SEQUENCE{
ciscoImageCheckSerialNum Integer32,
ciscoImageCheckImageName SnmpAdminString,
ciscoImageCheckStatus INTEGER,
ciscoImageCheckEntryStatus RowStatus}ciscoImageCheckSerialNum OBJECT-TYPESYNTAXInteger32(1..2147483647)
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"Object which specifies a unique entry in the
table. A management station wishing to initiate a
check operation should use a pseudo-random value for
this object when creating or modifying an instance of
a ciscoImageCheckOpEntry.
"::={ ciscoImageCheckOpEntry 1}ciscoImageCheckImageName OBJECT-TYPESYNTAXSnmpAdminString(SIZE(1..255))MAX-ACCESSread-createSTATUScurrentDESCRIPTION"Image file name that needs the verification.
If the Image name is NULL then it is assumed that
the image check is to be done with the image on
standby supervisor.
"::={ ciscoImageCheckOpEntry 2}ciscoImageCheckStatus OBJECT-TYPESYNTAXINTEGER{
none(1),inProgress(2),inCompatLoose(3),inCompatStrict(4),compatible(5),noStandby(6),pssErr(7),extractFail(8),fileParseErr(9),getIncompatErr(10)}MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The current status of the image check operation.
If the status is inCompatLoose(3) or
inCompatStrict(4), one can look at the detail
reasons of incompatibilities by looking at
ciscoImgChkResultsTable described below.
If the status is compatible, then there is no
need to look at the ciscoImgChkResultsTable.
If the status is noStandby(6), pssErr(7),
extractFail(8), fileParseErr(9) or
getIncompatErr(10), there is some internal error
in even starting the check compatibility process,
and hence the ciscoImgChkResultsTable should not
be read for any details.
inProgress(2) - Image check is in progress
inCompatLoose(3) - Loose incompatibility
inCompatStrict(4) - Strict incompatibility
compatible(5) - images are compatible
noStandby(6) - standby supervisor is absent
pssErr(7) - internal error
extractFail(8) - Could not extract image
fileParseErr(9) - Could not parse image
getIncompatErr(10) - internal error in determining
incompatibilities.
"::={ ciscoImageCheckOpEntry 3}ciscoImageCheckEntryStatus OBJECT-TYPESYNTAXRowStatusMAX-ACCESSread-createSTATUScurrentDESCRIPTION"The status of this table entry."
::={ ciscoImageCheckOpEntry 4}-- Image Check results TableciscoImgChkResultsTable OBJECT-TYPESYNTAXSEQUENCEOF CiscoImgChkResultsEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"This table lists the features and capabilities
that are incompatible for the request that was
made corresponding to the instance of
ciscoImgChkFeatureIndex in the ciscoImageCheckOpTable."::={ ciscoImageCheck 2}ciscoImgChkResultsEntry OBJECT-TYPESYNTAX CiscoImgChkResultsEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"An entry of ciscoImgChkResultsTable. "INDEX{
ciscoImageCheckSerialNum,
ciscoImgChkFeatureIndex,
ciscoImgChkCapabIndex
}::={ ciscoImgChkResultsTable 1}
CiscoImgChkResultsEntry ::=SEQUENCE{
ciscoImgChkFeatureIndex Integer32,
ciscoImgChkCapabIndex Integer32,
ciscoImgChkFeatureName SnmpAdminString,
ciscoImgChkCapabilityName SnmpAdminString,
ciscoImgChkCapabilityReq INTEGER,
ciscoImgChkInCompDescr SnmpAdminString}ciscoImgChkFeatureIndex OBJECT-TYPESYNTAXInteger32(1..65535)MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"The index of the incompatible feature."::={ ciscoImgChkResultsEntry 1}ciscoImgChkCapabIndex OBJECT-TYPESYNTAXInteger32(1..65535)
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"The index of the incompatible capability."::={ ciscoImgChkResultsEntry 2}ciscoImgChkFeatureName OBJECT-TYPESYNTAXSnmpAdminString(SIZE(1..32))MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The name of the incompatible feature.
The list of features is subject to
implementation in a given software
release. The current list of features is
as follows -
fspf - FSPF Routing Protocol Application
fcmpls - Multi-Protocol Label Switching
fib - FIB Manager
flogi - F Port Server
rscn - RSCN Module
fcns - Name Server
fcdomain - Domain Manager
fc-tunnel - FC MPLS tunnel
ipfc - Ipfc Manager
ipconf - IP Configuration Manager
ips - IPS Manager
port - Port Manager
port-channel - Port Channel Manager
span - Switch Port Analyzer
sysmgr-ver - System Manager version controller
vrrp-cfg - VRRP Configuration
vsan - VSAN manager
zone - Zone Server
"::={ ciscoImgChkResultsEntry 3}ciscoImgChkCapabilityName OBJECT-TYPESYNTAXSnmpAdminString(SIZE(1..64))MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The name of the incompatible capability.
The list of capabilities is subject to
implementation in a given software
release. The current list of capabilities
is as follows -
CAP_FEATURE_SPAN_FCFWD_STBY_POP_ENABLED
CAP_FEATURE_SPAN_IF_VSAN_SRC_MIX_NOT_ALLOWED
CAP_FEATURE_SPAN_IF_SRC_VSAN_FILTER_NOT_ALLOWED
CAP_FEATURE_SPAN_FC_TUNNEL_CFG
CAP_FEATURE_SPAN_ST_PORT_CFG
CAP_FEATURE_SPAN_FCIP_SRC_CFG
CAP_FEATURE_SPAN_ISCSI_SRC_CFG
CAP_FEATURE_ZS_READ_ONLY_ZONING
CAP_FEATURE_ZS_LUN_ZONING
CAP_FEATURE_PORT_MODE_ST_CFG
CAP_FEATURE_FC_TUNNEL_CFG
CAP_FEATURE_PORT_PERFORMANCE_BUF
"::={ ciscoImgChkResultsEntry 4}ciscoImgChkCapabilityReq OBJECT-TYPESYNTAXINTEGER{strict(1),loose(2)}MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Whether capability check is strict or loose. "::={ ciscoImgChkResultsEntry 5}ciscoImgChkInCompDescr OBJECT-TYPESYNTAXSnmpAdminString(SIZE(1..255))MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Description of the incompatibilty.
For example, if the name of the
incompatibilty (the instance of
ciscoImgChkCapabilityName) is
CAP_FEATURE_ZS_READ_ONLY_ZONING, then the
description will be -
'Zone Server - Read-only zoning configured'.
For each incompatibility name that appears in
ciscoImgChkCapabilityName, there will be a
corresponding description described by the
instance of this object.
"::={ ciscoImgChkResultsEntry 6}-- Conformance informationciscoImageCheckMIBConformance
OBJECTIDENTIFIER::={ ciscoImageCheckMIB 2}ciscoImageCheckMIBCompliances
OBJECTIDENTIFIER::={ ciscoImageCheckMIBConformance 1}ciscoImageCheckMIBGroups
OBJECTIDENTIFIER::={ ciscoImageCheckMIBConformance 2}ciscoImageCheckMIBCompliance MODULE-COMPLIANCESTATUScurrentDESCRIPTION"The compliance statement for entities which
implement the CISCO-IMAGE-CHECK-MIB."MODULEMANDATORY-GROUPS{
ciscoImageCheckOpGroup,
ciscoImgChkResultsGroup
}OBJECT ciscoImageCheckEntryStatus
SYNTAXINTEGER{
active(1),
createAndGo(4),
destroy(6)}DESCRIPTION"Only 'createAndGo', 'destroy' and 'active' need to
be supported."::={ ciscoImageCheckMIBCompliances 1}-- Units of ConformanceciscoImageCheckOpGroup OBJECT-GROUPOBJECTS{
ciscoImageCheckImageName,
ciscoImageCheckStatus,
ciscoImageCheckEntryStatus
}STATUScurrentDESCRIPTION"A collection of objects for Image Check
Operations group."::={ ciscoImageCheckMIBGroups 1}ciscoImgChkResultsGroup OBJECT-GROUP
OBJECTS{
ciscoImgChkFeatureName,
ciscoImgChkCapabilityName,
ciscoImgChkCapabilityReq,
ciscoImgChkInCompDescr
}STATUScurrentDESCRIPTION"A collection of objects for Image check results
group."::={ ciscoImageCheckMIBGroups 2}END